home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util1 / wrip_22.lha / WRip / WRip.doc < prev    next >
Text File  |  1995-11-13  |  5KB  |  147 lines
  1.  
  2.     $VER: WRip V2.2 (13.11.95)
  3.           ====================
  4.  
  5. Introducing
  6.   WRip is a CLI util which scans input data for known formats and save them.
  7.   The input can be a NDOS Disk or a normal file.
  8.   
  9.   
  10. Requirements
  11.   MC68020 or better (special 68000 version is also supplied)
  12.   Kickstart 2.05 (V37) or better
  13.   enough ram (disks will completely loaded to ram)
  14.   harddisk (strongly recommend)
  15.   
  16.  
  17. Disclaimer
  18.   No warranties of any kind are made as to the functionality of this
  19.   program. You are using it ENTIRE at your own risk.
  20.  
  21.  
  22. Installation
  23.   just copy WRip anywhere you like (e.g. C:)
  24.  
  25.  
  26. Using
  27.   - enter the directory where the ripped formats should stored (cd ...)
  28.     start WRip with input as argument (eg "WRip DF0:" or "WRip DH2:xyz.ab")
  29.      now WRip reads the disk / load the file
  30.      then it scans the data
  31.      if a format is recognized it will saved in the actual directory, the name
  32.      of the file is "format start_offset_in_source end_offset_in_source"
  33.   - its recommend to integrate WRip in your DirUtil (eg DOpus)
  34.     I use the following buttons : "WRip DF0:" "WRip RAD:" "WRip file" ...
  35.   - while WRip is loading or searching, you can break it with CTRL-C
  36.   - WRip is PURE and can made resident
  37.   - see CLI-Convention for further details
  38.  
  39.  
  40. WRip knows the follwing formats :
  41.   - Executable files ($000003F3), IFF files (FORM)
  42.   - various pack formats (ATM5, BOND, CrM2, CrM!, FIRE, ICE!, Ice!, IMP!,
  43.     LOB, PP20, RNC0, RNC1, RNC2, S300, S401, S403, S404, SSUR, TPWM, TSM!,
  44.     XPKF) and some clones (ATN!, CHFI, Z&G!)
  45. WRip gives you a message if one of the following crunch-id's were found :
  46.   - GC!, LZWH, SFHD, SFCD, PX20, PACK, FVL, PIco, S310, S400, "T.S "
  47.     (I don't know exact the format therefore WRip can't rip them)
  48.  
  49.  
  50. The CLI-Convention
  51.   - Template :
  52.     WRip INPUT/A,SD=SAVEDISK/S,SB=SAVEBOOTEXE/S,NE=NOEXE/S,DEEP/S,
  53.          MU=MAXUNPACKED/K/N,MR=MAXRATIO/K/N,TASKPRI/K/N
  54.  
  55.     INPUT/A        specify the data which will loaded
  56.             if it ends with ":" it is interpreted as a Device
  57.             otherwise as a file
  58.  
  59.     SD=SAVEDISK/S    if WRip has read a disk (device), the whole disk will
  60.             saved as "BIN__FullDisk" after scan
  61.  
  62.     SB=SAVEBOOTEXE/S if WRip has read a disk the Bootblock will saved as
  63.             a standard amiga executable namely "EXE__BootBlock"
  64.             
  65.     NE=NOEXE/S    if specified WRip will not scan for Executables
  66.             makes sense if you scan an Executable and need no
  67.             duplication of them (hoho!)
  68.  
  69.     DEEP/S        select the DEEP mode
  70.             in normal mode the area of a saved format will skipped
  71.             (ie not scanned), in DEEP mode these areas will also
  72.             scanned (ie not skipped)
  73.     
  74.     MU=MAXUNPACKED/K/N with this option you can set the internal variable
  75.             with same name (e.g. ... MU=150000 ...)
  76.             for any packed file found, WRip will compare the
  77.             unpacked size of the file against MAXUNPACKED, if
  78.             MAXUNPACKED is lower the file won't saved
  79.             it makes no sense to save a file that is unpacked
  80.             50 MB or so...
  81.             lower values speeds up the PP20-trace !
  82.             default: MAXUNPACKED=2000000
  83.  
  84.     MR=MAXRATIO/K/N    set internal variable MAXRATIO
  85.             this var is only used in PP20-trace at the moment
  86.             the var describes how large the unpacked file can be
  87.             dependent on the size packed, or with other words :
  88.             "packedsize * MAXRATIO > unpackedsize" must be true
  89.             otherwise the file won't save
  90.             higher values than default will dramatically slow down
  91.             the trace-mode (see chapter PP20-trace)
  92.             default: MAXRATIO=4 (useful values 2...10)
  93.             
  94.     TASKPRI/K/N    with this option you can set the taskpriority of the
  95.             scanroutine, this is useful if you have a PP20-trace
  96.             which will take a long time, and want to do some
  97.             other things with your machine
  98.             default: TASKPRI=-3 (allowed values -10...10)
  99.  
  100.  
  101. PP20 trace-mode
  102.   - to rip PowerPacker files a special trace mode is used
  103.   - if a "PP20" ID will found WRip swiches to trace mode
  104.     the trace-mode will stopped if :
  105.       a valid PP20-file will recognized and saved
  106.       the next "PP20" ID will found
  107.       the end of file is reached
  108.       the user press CTRL-C (quits only the PP20-trace, must pressed again to
  109.       leave the program)
  110.   - important for the speed of the trace mode are the value of MAXUNPACKED
  111.     and MAXRATIO
  112.     e.g. if you want to rip a soundfile you can set MAXRATIO=2 because
  113.     PowerPacker is not able to compress real samples better than faktor 2
  114.     (gain « 50%)
  115.     see also CLI-Convention
  116.  
  117.             
  118. Other related Programms
  119.   - for decrunching the XFD-package (aminet:util/pack/xfd107.lha) is
  120.     recommend
  121.   - a good program for ripping soundmodules is ExoticRipper
  122.     (aminet:mus/misc/ExoticRip229.lha)
  123.  
  124.  
  125. Bugs
  126.   - files saved can be corrupt because only ID and sizes are checked
  127.     (except CMP1,PP20,SSUR,TPWM they are always 100% clean)
  128.     the further process of corrupted files can crash other progs/your machine!
  129.   - not a bug :    never try to scan a FileSystemFormatted-Disk (resulting files
  130.         are waste, what else)
  131.  
  132.     
  133. Future plans
  134.   - new formats
  135.  
  136.  
  137. Contact
  138. EMail:    jah@pub.th-zwickau.de
  139. WWW:    http://www.th-zwickau.de/~jah
  140. Mail:    Bert Jahn
  141.     WE 9321
  142.     Otto-Hahn-Straße 14
  143.     Zwickau
  144.     08066
  145.     Germany
  146.  
  147.